<!DOCTYPE html>
<html lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>fwrite_string [HALCON算子参考手册]</title>
<style type="text/css">
      body {
    color: #000000;
    background-color: #ffffff;
    margin: 0;
    font-family: Arial, Helvetica, sans-serif;
}

.body_main {
    margin-left: 35px;
    margin-right: 35px;
}

@media screen and (min-width:992px) {

    .body_main {
        margin-left: 10%;
        margin-right: 10%;
    }

    table.toctable {
        width: 80%
    }
}

@media screen and (min-width:1400px) {

    .body_main {
        margin-left: 15%;
        margin-right: 15%;
    }

    table.toctable {
        width: 70%
    }
}

body>div ul ul {
    margin-left: inherit;
}

a:link {
    color: #0044cc;
}

a:link,
a:visited {
    text-decoration: none;
}

a:link:hover,
a:visited:hover {
    text-decoration: underline;
}

th {
    text-align: left;
}

h1,
h2,
h3,
h4,
h5,
h6 {
    text-rendering: optimizeLegibility;
    color: #666666;
}

code {
    font-family: monospace,monospace;
}

h1 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

h2 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

hr {
    border: 0;
    border-top: solid 1px #f28d26;
}

.pre {
    display: block;
    padding-bottom: 1ex;
    font-family: monospace;
    white-space: pre;
}

pre {
    font-family: monospace, monospace;
    padding: 1ex;
    white-space: pre-wrap;
}

.toc {
    font-size: 80%;
    border-top: 1px dashed #f28d26;
    border-bottom: 1px dashed #f28d26;
    padding-top: 5px;
    padding-bottom: 5px;
}

.inv {
    margin: 0;
    border: 0;
    padding: 0;
}

.banner {
    color: #666666;
    padding-left: 1em;
}

.logo {
    background-color: white;
}

.keyboard {
    font-size: 80%;
    padding-left: 3px;
    padding-right: 3px;
    border-radius: 5px;
    border-width: 1px;
    border-style: solid;
    border-color: #f28d26;
    background-color: #f3f3f3;
}

.warning {
    margin-top: 2ex;
    margin-bottom: 1ex;
    padding: 10px;
    text-align: center;
    border: 1px solid;
    color: #bb0000;
    background-color: #fff7f7
}

.imprint {
    margin-top: 1ex;
    font-size: 80%;
    color: #666666;
}

.imprinthead {
    font-weight: bolder;
    color: #666666;
}

.indexlink {
    text-align: right;
    padding-bottom: 5px;
}

.postscript {
    margin-top: 2ex;
    font-size: 80%;
    color: #666666
}

.evenrow {
    background-color: #e7e7ef;
    vertical-align: top;
}

.oddrow {
    background-color: #f7f7ff;
    vertical-align: top;
}

.headrow {
    background-color: #97979f;
    color: #ffffff;
    vertical-align: top;
}

.logorow {
    vertical-align: top;
}

.error {
    color: red;
}

.var {
    font-style: italic
}

.halconoperator {
    font-family: monospace, monospace;
}

span.operator {
    font-family: monospace, monospace;
}

span.procedure {
    font-family: monospace, monospace;
}

span.operation {
    font-family: monospace, monospace;
}

span.feature {
    font-family: Arial, Helvetica, Homerton, sans-serif;
}

ul {
    padding-left: 1.2em;
}

li.dot {
    list-style-type: square;
    color: #f28d26;
}

.breadcrumb {
    font-size: 80%;
    color: white;
    background-color: #062d64;
    margin-bottom: 20px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 15px;
}

.webbar {
    font-size: 80%;
    background-color: #dddddd;
    margin-top: 0px;
    margin-left: -35px;
    margin-right: -35px;
    margin-bottom: 0px;
    padding-top: 5px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 5px;
}

.footer {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    border-top: 1px dashed #f28d26;
    font-size: 80%;
    color: #666666;
    padding-bottom: 8px;
}

.footer .socialmedia a {
    padding-left: 7px;
}

.socialmedia {
    padding-top: 10px;
}

.copyright {
    margin-top: 19px;
}

.breadcrumb a {
    color: #ffffff;
    border-bottom: 1px solid white;
}

.breadcrumb a:link:hover,
.breadcrumb a:visited:hover {
    text-decoration: none;
    border-bottom: none;
}

.heading {
    margin-top: 1ex;
    font-size: 110%;
    font-weight: bold;
    color: #666666;
}

.text {
    color: black;
}

.example {
    font-size: 80%;
    background-color: #f3f3f3;
    border: 1px dashed #666666;
    padding: 10px;
}

.displaymath {
    display: block;
    text-align: center;
    margin-top: 1ex;
    margin-bottom: 1ex;
}

.title {
    float: left;
    padding-top: 3px;
    padding-bottom: 3px;
}

.signnote {
    font-family: Arial, Helvetica, Homerton, sans-serif;
    font-size: 80%;
    color: #666666;
    font-weight: lighter;
    font-style: italic
}

.par {
    margin-bottom: 1.5em;
}

.parhead {
    text-align: right;
}

.parname {
    float: left;
}

.pardesc {
    font-size: 85%;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
    margin-left: 2em;
}

.parcat {
    color: #666;
    font-weight: bold;
}

*[data-if=cpp],
*[data-if=c],
*[data-if=dotnet],
*[data-if=com],
*[data-if=python] {
    display: none;
}

.tabbar {
    text-align: right;
    border-bottom: 1px solid #f28d26;
    margin-bottom: 0.5em;
}

ul.tabs {
    padding-top: 3px;
    padding-bottom: 3px;
    margin-top: 10px;
    margin-bottom: 0;
    font-size: 80%
}

ul.tabs li {
    padding-top: 3px;
    padding-bottom: 3px;
    display: inline;
    overflow: hidden;
    list-style-type: none;
    margin: 0;
    margin-left: 8px;
    border-top: 1px solid #666;
    border-left: 1px solid #666;
    border-right: 1px solid #666;
}

ul.tabs li.active {
    border-left: 1px solid #f28d26;
    border-right: 1px solid #f28d26;
    border-top: 1px solid #f28d26;
    border-bottom: 1px solid #fff;
}

ul.tabs li.inactive {
    background-color: #eee;
}

ul.tabs li a {
    padding-left: 5px;
    padding-right: 5px;
    color: #666;
}

ul.tabs li a:link:hover {
    text-decoration: none;
}

ul.tabs li.inactive a {
    color: #666;
}

ul.tabs li.active a {
    color: black;
}

dl.generic dd {
    margin-bottom: 1em;
}

.pari {
    color: olive;
}

.paro {
    color: maroon;
}

.comment {
    font-size: 80%;
    color: green;
    white-space: nowrap;
}

table.grid {
    border-collapse: collapse;
}

table.grid td {
    padding: 5px;
    border: 1px solid;
}

table.layout {
    border: 0px;
}

table.layout td {
    padding: 5px;
}

table.table {
    border-collapse: collapse;
}

table.table td {
    padding: 5px;
    border-left: 0px;
    border-right: 0px;
}

table.table tr:last-child {
    border-bottom: 1px solid;
}

table.table th {
    padding: 5px;
    border-top: 1px solid;
    border-bottom: 1px solid;
    border-left: 0px;
    border-right: 0px;
}

.details_summary {
    cursor: pointer;
}

table.toctable {
    width: 100%;
}

table.toctable col:first-child {
    width: 20%;
}

table.toctable col:nth-last-child(2) {
    width: 8%;
}

table.altcolored tr:nth-child(even) {
    background-color: #f3f3f3;
}

    </style>
<!--OP_REF_STYLE_END-->
<script>
    <!--
var active_lang='hdevelop';function switchVisibility(obj,active_lang,new_lang)
{var display_style='inline';
for(var i=0;i<obj.length;i++)
{if(obj.item(i).getAttribute('data-if')==new_lang)
{obj.item(i).style.display=display_style;}
if(obj.item(i).getAttribute('data-if')==active_lang)
{obj.item(i).style.display='none';}}
return;}
function toggleLanguage(new_lang,initial)
{if(active_lang!=new_lang)
{var lis=document.getElementsByTagName('li');for(var i=0;i<lis.length;i++)
{if(lis.item(i).id=='syn-'+new_lang)
{lis.item(i).className='active';}
else
{lis.item(i).className='inactive';}}
var divs=document.getElementsByTagName('div');var spans=document.getElementsByTagName('span');switchVisibility(divs,active_lang,new_lang);switchVisibility(spans,active_lang,new_lang);if(!initial)
{setCookie("halcon_reference_language",new_lang,null,null);}
active_lang=new_lang;}
return;}
function setCookie(name,value,domain,exp_offset,path,secure)
{localStorage.setItem(name,value);}
function getCookie(name)
{return localStorage.getItem(name);}
function initialize()
{var qs=location.href.split('?')[1];var qs_lang_raw=location.href.split('interface=')[1];var qs_lang;if(qs_lang_raw)
{qs_lang=qs_lang_raw.split('#')[0];}
var cookie_lang=getCookie("halcon_reference_language");var new_lang;if((qs_lang=="hdevelop")||(qs_lang=="dotnet")||(qs_lang=="python")||(qs_lang=="cpp")||(qs_lang=="c"))
{new_lang=qs_lang;setCookie("halcon_reference_language",new_lang,null,null);}
else if((cookie_lang=="hdevelop")||(cookie_lang=="dotnet")||(cookie_lang=="python")||(cookie_lang=="cpp")||(cookie_lang=="c"))
{new_lang=cookie_lang;}
else
{new_lang="hdevelop";}
toggleLanguage(new_lang,1);return;}
-->

  </script>
</head>
<body onload="initialize();">
<div class="breadcrumb">
<br class="inv"><a href="index.html">目录</a> / <a href="toc_file.html">File</a> / <a href="toc_file_access.html">Access</a><br class="inv">
</div>
<div class="body_main">
<div class="tabbar"><ul class="tabs">
<li id="syn-hdevelop" class="active"><a href="javascript:void(0);" onclick="toggleLanguage('hdevelop')" onfocus="blur()">HDevelop</a></li>
<li id="syn-dotnet" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('dotnet')" onfocus="blur()">.NET</a></li>
<li id="syn-python" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('python')" onfocus="blur()">Python</a></li>
<li id="syn-cpp" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('cpp')" onfocus="blur()">C++</a></li>
<li id="syn-c" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('c')" onfocus="blur()">C</a></li>
</ul></div>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<!--OP_REF_HEADER_END-->
<h1 id="sec_name">
<span data-if="hdevelop" style="display:inline;">fwrite_string</span><span data-if="c" style="display:none;">T_fwrite_string</span><span data-if="cpp" style="display:none;">FwriteString</span><span data-if="dotnet" style="display:none;">FwriteString</span><span data-if="python" style="display:none;">fwrite_string</span> (算子名称)</h1>
<h2>名称</h2>
<p><code><span data-if="hdevelop" style="display:inline;">fwrite_string</span><span data-if="c" style="display:none;">T_fwrite_string</span><span data-if="cpp" style="display:none;">FwriteString</span><span data-if="dotnet" style="display:none;">FwriteString</span><span data-if="python" style="display:none;">fwrite_string</span></code> — Write strings and numbers into a text file.</p>
<h2 id="sec_synopsis">参数签名</h2>
<div data-if="hdevelop" style="display:inline;">
<p>
<code><b>fwrite_string</b>( :  : <a href="#FileHandle"><i>FileHandle</i></a>, <a href="#String"><i>String</i></a> : )</code></p>
</div>
<div data-if="c" style="display:none;">
<p>
<code>Herror <b>T_fwrite_string</b>(const Htuple <a href="#FileHandle"><i>FileHandle</i></a>, const Htuple <a href="#String"><i>String</i></a>)</code></p>
</div>
<div data-if="cpp" style="display:none;">
<p>
<code>void <b>FwriteString</b>(const HTuple&amp; <a href="#FileHandle"><i>FileHandle</i></a>, const HTuple&amp; <a href="#String"><i>String</i></a>)</code></p>
<p>
<code>void <a href="HFile.html">HFile</a>::<b>FwriteString</b>(const HTuple&amp; <a href="#String"><i>String</i></a>) const</code></p>
<p>
<code>void <a href="HFile.html">HFile</a>::<b>FwriteString</b>(const HString&amp; <a href="#String"><i>String</i></a>) const</code></p>
<p>
<code>void <a href="HFile.html">HFile</a>::<b>FwriteString</b>(const char* <a href="#String"><i>String</i></a>) const</code></p>
<p>
<code>void <a href="HFile.html">HFile</a>::<b>FwriteString</b>(const wchar_t* <a href="#String"><i>String</i></a>) const  <span class="signnote">
            (
            Windows only)
          </span></code></p>
</div>
<div data-if="com" style="display:none;"></div>
<div data-if="dotnet" style="display:none;">
<p>
<code>static void <a href="HOperatorSet.html">HOperatorSet</a>.<b>FwriteString</b>(<a href="HTuple.html">HTuple</a> <a href="#FileHandle"><i>fileHandle</i></a>, <a href="HTuple.html">HTuple</a> <a href="#String"><i>stringVal</i></a>)</code></p>
<p>
<code>void <a href="HFile.html">HFile</a>.<b>FwriteString</b>(<a href="HTuple.html">HTuple</a> <a href="#String"><i>stringVal</i></a>)</code></p>
<p>
<code>void <a href="HFile.html">HFile</a>.<b>FwriteString</b>(string <a href="#String"><i>stringVal</i></a>)</code></p>
</div>
<div data-if="python" style="display:none;">
<p>
<code>def <b>fwrite_string</b>(<a href="#FileHandle"><i>file_handle</i></a>: HHandle, <a href="#String"><i>string</i></a>: MaybeSequence[Union[int, float, str]]) -&gt; None</code></p>
</div>
<h2 id="sec_description">描述</h2>
<p>该算子 <code><span data-if="hdevelop" style="display:inline">fwrite_string</span><span data-if="c" style="display:none">fwrite_string</span><span data-if="cpp" style="display:none">FwriteString</span><span data-if="com" style="display:none">FwriteString</span><span data-if="dotnet" style="display:none">FwriteString</span><span data-if="python" style="display:none">fwrite_string</span></code> writes one or more strings or numbers
to the output file defined by the handle <a href="#FileHandle"><i><code><span data-if="hdevelop" style="display:inline">FileHandle</span><span data-if="c" style="display:none">FileHandle</span><span data-if="cpp" style="display:none">FileHandle</span><span data-if="com" style="display:none">FileHandle</span><span data-if="dotnet" style="display:none">fileHandle</span><span data-if="python" style="display:none">file_handle</span></code></i></a>.
The output file must have been opened with <a href="open_file.html"><code><span data-if="hdevelop" style="display:inline">open_file</span><span data-if="c" style="display:none">open_file</span><span data-if="cpp" style="display:none">OpenFile</span><span data-if="com" style="display:none">OpenFile</span><span data-if="dotnet" style="display:none">OpenFile</span><span data-if="python" style="display:none">open_file</span></code></a> in text format.
</p>
<p>Strings and numbers that are to be written into the file are passed via the
input parameter <a href="#String"><i><code><span data-if="hdevelop" style="display:inline">String</span><span data-if="c" style="display:none">String</span><span data-if="cpp" style="display:none">String</span><span data-if="com" style="display:none">String</span><span data-if="dotnet" style="display:none">stringVal</span><span data-if="python" style="display:none">string</span></code></i></a> to 该算子 <code><span data-if="hdevelop" style="display:inline">fwrite_string</span><span data-if="c" style="display:none">fwrite_string</span><span data-if="cpp" style="display:none">FwriteString</span><span data-if="com" style="display:none">FwriteString</span><span data-if="dotnet" style="display:none">FwriteString</span><span data-if="python" style="display:none">fwrite_string</span></code>.
The parameter <a href="#String"><i><code><span data-if="hdevelop" style="display:inline">String</span><span data-if="c" style="display:none">String</span><span data-if="cpp" style="display:none">String</span><span data-if="com" style="display:none">String</span><span data-if="dotnet" style="display:none">stringVal</span><span data-if="python" style="display:none">string</span></code></i></a> accepts also tuples where strings
and numbers are mixed.
All elements of the tuple are written consecutively into the file without
blanks or other separators in between.
Numbers are converted into a string before they are written.
</p>
<p>该算子 <code><span data-if="hdevelop" style="display:inline">fwrite_string</span><span data-if="c" style="display:none">fwrite_string</span><span data-if="cpp" style="display:none">FwriteString</span><span data-if="com" style="display:none">FwriteString</span><span data-if="dotnet" style="display:none">FwriteString</span><span data-if="python" style="display:none">fwrite_string</span></code> emits a low-level error message, when the
string cannot be transcoded without loss of information into the specified
file encoding.
This can only happen when the file encoding is
<i><span data-if="hdevelop" style="display:inline">'locale_encoding'</span><span data-if="c" style="display:none">"locale_encoding"</span><span data-if="cpp" style="display:none">"locale_encoding"</span><span data-if="com" style="display:none">"locale_encoding"</span><span data-if="dotnet" style="display:none">"locale_encoding"</span><span data-if="python" style="display:none">"locale_encoding"</span></i> and the current encoding of the HALCON library is
<i><span data-if="hdevelop" style="display:inline">'utf8'</span><span data-if="c" style="display:none">"utf8"</span><span data-if="cpp" style="display:none">"utf8"</span><span data-if="com" style="display:none">"utf8"</span><span data-if="dotnet" style="display:none">"utf8"</span><span data-if="python" style="display:none">"utf8"</span></i> (see <a href="set_system.html"><code><span data-if="hdevelop" style="display:inline">set_system(::'filename_encoding','utf8':)</span><span data-if="c" style="display:none">set_system("filename_encoding","utf8")</span><span data-if="cpp" style="display:none">SetSystem("filename_encoding","utf8")</span><span data-if="com" style="display:none">SetSystem("filename_encoding","utf8")</span><span data-if="dotnet" style="display:none">SetSystem("filename_encoding","utf8")</span><span data-if="python" style="display:none">set_system("filename_encoding","utf8")</span></code></a>).
</p>
<p>The call <a href="set_system.html"><code><span data-if="hdevelop" style="display:inline">set_system(::'flush_file', &lt;boolean-value&gt;:)</span><span data-if="c" style="display:none">set_system("flush_file", &lt;boolean-value&gt;)</span><span data-if="cpp" style="display:none">SetSystem("flush_file", &lt;boolean-value&gt;)</span><span data-if="com" style="display:none">SetSystem("flush_file", &lt;boolean-value&gt;)</span><span data-if="dotnet" style="display:none">SetSystem("flush_file", &lt;boolean-value&gt;)</span><span data-if="python" style="display:none">set_system("flush_file", &lt;boolean-value&gt;)</span></code></a>
determines whether the output characters are immediately written to the file
or not.
If the value <i><span data-if="hdevelop" style="display:inline">'flush_file'</span><span data-if="c" style="display:none">"flush_file"</span><span data-if="cpp" style="display:none">"flush_file"</span><span data-if="com" style="display:none">"flush_file"</span><span data-if="dotnet" style="display:none">"flush_file"</span><span data-if="python" style="display:none">"flush_file"</span></i> is set to <i><span data-if="hdevelop" style="display:inline">'false'</span><span data-if="c" style="display:none">"false"</span><span data-if="cpp" style="display:none">"false"</span><span data-if="com" style="display:none">"false"</span><span data-if="dotnet" style="display:none">"false"</span><span data-if="python" style="display:none">"false"</span></i>, the characters
(especially in case of screen output) show up only after 该算子
<a href="fnew_line.html"><code><span data-if="hdevelop" style="display:inline">fnew_line</span><span data-if="c" style="display:none">fnew_line</span><span data-if="cpp" style="display:none">FnewLine</span><span data-if="com" style="display:none">FnewLine</span><span data-if="dotnet" style="display:none">FnewLine</span><span data-if="python" style="display:none">fnew_line</span></code></a> is called.
</p>
<h2 id="sec_execution">运行信息</h2>
<ul>
  <li>多线程类型:可重入(与非独占操作符并行运行)。</li>
<li>多线程作用域:全局(可以从任何线程调用)。</li>
  <li>未经并行化处理。</li>
</ul>
<h2 id="sec_parameters">参数表</h2>
  <div class="par">
<div class="parhead">
<span id="FileHandle" class="parname"><b><code><span data-if="hdevelop" style="display:inline">FileHandle</span><span data-if="c" style="display:none">FileHandle</span><span data-if="cpp" style="display:none">FileHandle</span><span data-if="com" style="display:none">FileHandle</span><span data-if="dotnet" style="display:none">fileHandle</span><span data-if="python" style="display:none">file_handle</span></code></b> (input_control)  </span><span>file <code>→</code> <span data-if="dotnet" style="display:none"><a href="HFile.html">HFile</a>, </span><span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">HHandle</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (handle)</span><span data-if="dotnet" style="display:none"> (<i>IntPtr</i>)</span><span data-if="cpp" style="display:none"> (<i>HHandle</i>)</span><span data-if="c" style="display:none"> (<i>handle</i>)</span></span>
</div>
<p class="pardesc">File handle.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="String" class="parname"><b><code><span data-if="hdevelop" style="display:inline">String</span><span data-if="c" style="display:none">String</span><span data-if="cpp" style="display:none">String</span><span data-if="com" style="display:none">String</span><span data-if="dotnet" style="display:none">stringVal</span><span data-if="python" style="display:none">string</span></code></b> (input_control)  </span><span>string(-array) <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">MaybeSequence[Union[int, float, str]]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string / </span><span data-if="hdevelop" style="display:inline">integer / </span><span data-if="hdevelop" style="display:inline">real)</span><span data-if="dotnet" style="display:none"> (<i>string</i> / </span><span data-if="dotnet" style="display:none">int / </span><span data-if="dotnet" style="display:none">long / </span><span data-if="dotnet" style="display:none">double)</span><span data-if="cpp" style="display:none"> (<i>HString</i> / </span><span data-if="cpp" style="display:none">Hlong / </span><span data-if="cpp" style="display:none">double)</span><span data-if="c" style="display:none"> (<i>char*</i> / </span><span data-if="c" style="display:none">Hlong / </span><span data-if="c" style="display:none">double)</span></span>
</div>
<p class="pardesc">Values to be written into the file.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'hallo'</span>
    <span data-if="c" style="display:none">"hallo"</span>
    <span data-if="cpp" style="display:none">"hallo"</span>
    <span data-if="com" style="display:none">"hallo"</span>
    <span data-if="dotnet" style="display:none">"hallo"</span>
    <span data-if="python" style="display:none">"hallo"</span>
</p>
</div>
<div data-if="hdevelop" style="display:inline">
<h2 id="sec_example_hdevelop">例程 (HDevelop)</h2>
<pre class="example">
fwrite_string(FileHandle,['text with numbers:',5,' and ',1.0])
* results in the following output:
* 'text with numbers:5 and 1.00000'
</pre>
</div>
<div data-if="c" style="display:none">
<h2 id="sec_example_c">例程 (C)</h2>
<pre class="example">
   fwrite_string(FileHandle,"text with numbers: ");
   fwrite_string(FileHandle,"5");
   fwrite_string(FileHandle," and ");
   fwrite_string(FileHandle,"1.0");
/* results in the following output:       */
/*    'text with numbers: 5 and 1.00000'   */

/* Tupel Version */
  int  i;
  double d;
  Htuple Tuple;

  create_tuple(&amp;Tuple,4);
  i = 5;
  d = 10.0;
  set_s(Tuple,"text with numbers: ",0);
  set_i(Tuple,i,1);
  set_s(Tuple," and ",2);
  set_d(Tuple,d,3);
  T_fwrite_string(FileHandle,HilfsTuple);
</pre>
</div>
<div data-if="cpp" style="display:none">
<h2 id="sec_example_cpp">例程 (HDevelop)</h2>
<pre class="example">
fwrite_string(FileHandle,['text with numbers:',5,' and ',1.0])
* results in the following output:
* 'text with numbers:5 and 1.00000'
</pre>
</div>
<div data-if="com" style="display:none">
<h2 id="sec_example_com">例程 (HDevelop)</h2>
<pre class="example">
fwrite_string(FileHandle,['text with numbers:',5,' and ',1.0])
* results in the following output:
* 'text with numbers:5 and 1.00000'
</pre>
</div>
<div data-if="dotnet" style="display:none">
<h2 id="sec_example_dotnet">例程 (HDevelop)</h2>
<pre class="example">
fwrite_string(FileHandle,['text with numbers:',5,' and ',1.0])
* results in the following output:
* 'text with numbers:5 and 1.00000'
</pre>
</div>
<h2 id="sec_result">结果</h2>
<p>If the writing procedure was carried out
successfully, 该算子 <code><span data-if="hdevelop" style="display:inline">fwrite_string</span><span data-if="c" style="display:none">fwrite_string</span><span data-if="cpp" style="display:none">FwriteString</span><span data-if="com" style="display:none">FwriteString</span><span data-if="dotnet" style="display:none">FwriteString</span><span data-if="python" style="display:none">fwrite_string</span></code>
返回值 <TT>2</TT> (
      <TT>H_MSG_TRUE</TT>)
    . Otherwise, an exception is raised.
Encoding errors have no influence on the result state.
</p>
<h2 id="sec_predecessors">可能的前置算子</h2>
<p>
<code><a href="open_file.html"><span data-if="hdevelop" style="display:inline">open_file</span><span data-if="c" style="display:none">open_file</span><span data-if="cpp" style="display:none">OpenFile</span><span data-if="com" style="display:none">OpenFile</span><span data-if="dotnet" style="display:none">OpenFile</span><span data-if="python" style="display:none">open_file</span></a></code>
</p>
<h2 id="sec_successors">可能的后置算子</h2>
<p>
<code><a href="close_file.html"><span data-if="hdevelop" style="display:inline">close_file</span><span data-if="c" style="display:none">close_file</span><span data-if="cpp" style="display:none">CloseFile</span><span data-if="com" style="display:none">CloseFile</span><span data-if="dotnet" style="display:none">CloseFile</span><span data-if="python" style="display:none">close_file</span></a></code>
</p>
<h2 id="sec_alternatives">可替代算子</h2>
<p>
<code><a href="write_string.html"><span data-if="hdevelop" style="display:inline">write_string</span><span data-if="c" style="display:none">write_string</span><span data-if="cpp" style="display:none">WriteString</span><span data-if="com" style="display:none">WriteString</span><span data-if="dotnet" style="display:none">WriteString</span><span data-if="python" style="display:none">write_string</span></a></code>
</p>
<h2 id="sec_see">参考其它</h2>
<p>
<code><a href="open_file.html"><span data-if="hdevelop" style="display:inline">open_file</span><span data-if="c" style="display:none">open_file</span><span data-if="cpp" style="display:none">OpenFile</span><span data-if="com" style="display:none">OpenFile</span><span data-if="dotnet" style="display:none">OpenFile</span><span data-if="python" style="display:none">open_file</span></a></code>, 
<code><a href="close_file.html"><span data-if="hdevelop" style="display:inline">close_file</span><span data-if="c" style="display:none">close_file</span><span data-if="cpp" style="display:none">CloseFile</span><span data-if="com" style="display:none">CloseFile</span><span data-if="dotnet" style="display:none">CloseFile</span><span data-if="python" style="display:none">close_file</span></a></code>, 
<code><a href="set_system.html"><span data-if="hdevelop" style="display:inline">set_system</span><span data-if="c" style="display:none">set_system</span><span data-if="cpp" style="display:none">SetSystem</span><span data-if="com" style="display:none">SetSystem</span><span data-if="dotnet" style="display:none">SetSystem</span><span data-if="python" style="display:none">set_system</span></a></code>
</p>
<h2 id="sec_module">模块</h2>
<p>
Foundation</p>
<!--OP_REF_FOOTER_START-->
<hr>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<div class="footer">
<div class="copyright">HALCON算子参考手册 Copyright © 2015-2023 51Halcon</div>
</div>
</div>
</body>
</html>
